levelbar: Docs tweaks

diff --git a/gtk/gtklevelbar.c b/gtk/gtklevelbar.c
index ed34f2816e0c5345baaa6766a81a5a83ef9fa397..1208297b2c92ed073e3be1f7562e2d99218e0e2c 100644 (file)
--- a/gtk/gtklevelbar.c
+++ b/gtk/gtklevelbar.c
@@ -21,17 +21,18 @@
 /**
  * GtkLevelBar:
  *
- * The `GtkLevelBar` is a bar widget that can be used
- * as a level indicator. Typical use cases are displaying the strength
- * of a password, or showing the charge level of a battery.
+ * `GtkLevelBar` is a widget that can be used as a level indicator.
+ *
+ * Typical use cases are displaying the strength of a password, or
+ * showing the charge level of a battery.
  *
  * ![An example GtkLevelBar](levelbar.png)
  *
  * Use [method@Gtk.LevelBar.set_value] to set the current value, and
  * [method@Gtk.LevelBar.add_offset_value] to set the value offsets at which
  * the bar will be considered in a different state. GTK will add a few
- * offsets by default on the level bar: #GTK_LEVEL_BAR_OFFSET_LOW,
- * #GTK_LEVEL_BAR_OFFSET_HIGH and #GTK_LEVEL_BAR_OFFSET_FULL, with
+ * offsets by default on the level bar: %GTK_LEVEL_BAR_OFFSET_LOW,
+ * %GTK_LEVEL_BAR_OFFSET_HIGH and %GTK_LEVEL_BAR_OFFSET_FULL, with
  * values 0.25, 0.75 and 1.0 respectively.
  *
  * Note that it is your responsibility to update preexisting offsets
@@ -94,14 +95,14 @@
  *
  * # CSS nodes
  *
- * |[<!-- language="plain" -->
+ * ```
  * levelbar[.discrete]
  * ╰── trough
  *     ├── block.filled.level-name
  *     ┊
  *     ├── block.empty
  *     ┊
- * ]|
+ * ```
  *
  * `GtkLevelBar` has a main CSS node with name levelbar and one of the style
  * classes .discrete or .continuous and a subnode with name trough. Below the